WELCOME PM ON FIRST LOGIN
A phpBB extension by Thoul
Current Hack Release: 1.0.3
Official Supported phpBB Release: 2.0.17 - 2.0.21

Table of Contents:
1) Introduction
2) Release Notes
3) Included Files
4) License
5) Features
6) Mini FAQ
7) Contact Information

--------------------------------------------------------------------------------
                                  INTRODUCTION
--------------------------------------------------------------------------------

This is a small add-on for Duvelske's WPM hack.  WPM is a hack that gives a
phpBB board the ability to automatically send a "welcome to the board" private
message to each user that registers.  Included in that hack is an admin panel
interface to control various settings of the welcome messages.

Unfortunately, some boards are occasionally beset by registration spammers and
bots or users that register but never activate their account or return to the
board.  In these cases, a board could easily wind up with a massive number of
welcome messages that will never be read.  These useless messages take up space
in the database, slowing the forum for legitimate members and damaging the
administrator's reputation.

Welcome PM on First Login changes the behavior of WPM to send welcome messages
after a member's first log in instead of their registration.  This prevents the
unhealthy build up of messages that would never be read by fake or non-returning
users.  Only members that return to the site get the welcome messages.

Existing members will not receive welcome messages when using Welcome PM on
First Login.

--------------------------------------------------------------------------------
                                 RELEASE NOTES
--------------------------------------------------------------------------------

For a full list of changes in each version of this hack, look at the included
changelog.txt file.  For previous release notes, see release_notes.txt.

Version 1.0.3 - July 13, 2006 07:00 pm Eastern Time
A few more bug fixes, this time for a rare error that might occur after certain
login errors and a bug that might prevent some users from receiving their
welcome PM.

--------------------------------------------------------------------------------
                                 INCLUDED FILES
--------------------------------------------------------------------------------

When the ZIP file for this hack is unpacked, the following new directories
may be created on your system, each containing the noted files.
	docs - Important documents for installation, upgrading, etc.
	hack_files - New files that will be added to your forum.
	hack_install - Installer files for this hack.
	premodded - Original phpBB files already modified for use with this hack.

The "docs" directory may contain the following files:
	release_notes.txt - Short summary of changes in each version of this hack.
	changelog.txt - Detailed list of changes to each version.
	install.txt - Instructions for installing this hack.
	upgrade.txt - Instructions for upgrading from a previous version.
	uninstall.txt - Instructions for uninstalling this hack.
	file_edits.txt - Detailed list of changes to be made in existing files.
	gpl.txt - A copy of the GNU General Public License.  See License section.
The "docs" directory may also contain a file with the extension .hl, such as
"contact.hl."  See the Mini FAQ section for details.

--------------------------------------------------------------------------------
                                    LICENSE
--------------------------------------------------------------------------------

The files in this package (collectively known as a modification, hack,
extension, or add-on), are free software distributed under the GNU General
Public License, Version 2.  A copy of this license is available from the Free
Software Foundation and should be found in the docs/gpl.txt file that came with
this package.

In addition, this modification may contain code from a 2.0.x release of phpBB in
the form of instructions or modified files.  Any such code is copyright by
the phpBB Group and distributed in accordance with the GNU General Public 
License under which that phpBB version was released.  Please see the latest
release of phpBB 2.0.x for those license and copyright details.

Also, this modification may contain code from other modifications released under
the GNU General Public License.  Any such code is copyright by the author(s)
of those modifications and distributed in accordance with that License.  Please
see the appropriate release of those modifications for those license and
copyright details.  Any such modifications are listed below:
	WPM 1.0.8 by Duvelske

Finally, all original code and images in this package are copyright 2006 by
Jeremy Rogers.

--------------------------------------------------------------------------------
                                    FEATURES
--------------------------------------------------------------------------------

-Alters Duvelske's WPM hack to send messages during a member's first login, instead of registration.
-Prevents build up of private messages that will never be read.
-Helps to keep your forum's database smaller and running smoothly.
-Based on WPM 1.0.8. Also works with WPM 1.0.9. Not tested or designed for the
	Nuke version of WPM.

--------------------------------------------------------------------------------
                                    MINI FAQ
--------------------------------------------------------------------------------

Q. I don't know how to install this?  What should I do?
A. Installation instructions can be found in the docs/install.txt file.  If you
   have not installed a hack before, then you may have problems understanding
   the format of some instructions.  There are several guides available online
   that explain this format.  I recommend the ones found in the phpBBHacks.com
   Tutorials section (see Contact Information).

Q. The install/upgrade/uninstall instructions say unzipping the hack should have
   created new directories, but it didn't?  What do I do?
A. Those instructions all assume your archive software program unpacks files
   into the directories they were stored in when packed in the ZIP file.  If it
   doesn't, you're going to be confused when you try working through the
   instructions.  Try changing some settings in the program or using a different
   one.

Q. Are any non-English language file packs available for this hack?
A. Maybe, maybe not.  English is my only language, so any language pack
   releases are dependent solely on the generosity and work of others.

Q. There is a .hl file in the docs/ directory.  What should I do with it?
A. This file is provided for use with the Mods/Hack List hack written by
   Nivisec.  If you do not have Nivisec's hack installed on your forum, you can
   ignore the file.  If you do have his hack installed, then that hack has
   instructions for using the .hl file.

Q. Can I customize my installation in other ways not documented in this package?
A. This is usually possible.  Check out the Docs and Tutorials section of the
   phpBB Smith web site to see if I have listed any possibilities there.

Q. I need more help!
A. The Contact Information section of this file lists sites that you can check
   for support, lists of known bugs and fixes, and solutions to problems other
   people may have encountered.  If you are having a problem with installing
   this hack, please make sure you are following the installation instructions
   in docs/install.txt.

--------------------------------------------------------------------------------
                              CONTACT INFORMATION
--------------------------------------------------------------------------------

To download older or new versions of my hacks, please visit these web sites:
phpBB Smith      http://www.phpbbsmith.com/            (Old and New versions)
phpBBHacks.com   http://www.phpbbhacks.com/            (Latest version only)

phpBB Smith is my personal phpBB hacking related web site and therefore tends to
get new releases first, but phpBBHacks does have some exclusive releases from
me.  phpBB Smith is the best place to look for add-ons, language packs, image
sets, FAQs, and other material from myself.

If you are having a problem with one of my modifications and would like support,
please visit either phpBB Smith or phpBBHacks.  As of this release, I do visit
both of these regularly and will try to answer any questions that come to my
attention there.  To increase the speed in which you get an answer to your
question, I strongly recommend that you search those forums using key words that
describe your problem.  If the question has already been answered, a good search
will give you the answer more quickly than waiting for a post to be answered.

It is not necessary to post the same question on both forums, unless I cannot
answer your question at phpBB Smith.  phpBBHacks has a helpful Support Team that
may be able to answer questions I cannot.

If you need to e-mail me, I can be reached at thoul@phpbbsmith.com.  I do
prefer not to give support for hacks via e-mail, as forum posts can help many
people with identical problems at different points in time.  I do not use
instant messenger programs.

If you wish to be informed by e-mail when I release an update to this or my
other modifications, there's a mailing list you can subscribe to at:
http://www.phpbbsmith.com/mailinglist.html
Sourceforge.net users can also monitor releases from the Sourceforge.net
interface for project "darkmods."

Have a nice day. :D